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This is only the third issue of our newsletter and we're 
pleased to see that we are mailing to over 37 people. This issue 
should -really be sub-titled "Programming in Assembly Language" 
because in this issue we have a preview of Exidy's new Development 
PAC, as well as the beginning of a continuing article that is 
meant as a primer for Z-80 Assembly Language. This article is 
being handled by Tom Harper, who, unfortunately, as ill at the 
time of the publication of the last newsletter and was not able to 
prepare MEMTEST. This month, however, as a suppliment to his 
article on Assembly Language, he has supplied us with an 
explanation of his progran. | 

This month we are pushing the need for programs from you. We 
would like to expand the User's Group Software library as much as 
possible. We already have programs that will make up volumes six 
tnrough nine, and wetll be telling you about those at a later 
date, but we need even more. Some ideas for programs can be found 
in this newsletter in tne review of the Questionnaires. Here are 
some other suggestions: Bombardment, Star Trek/Wars space battle 
games, business aplication programs, accounting, and sorcerer 
interfacing and printer routines. 

Along with the preliminary copy of the Development Pac we 
have in house, we now have the new Sorcerer Technical Manuals in 
stock. 

No, we were not kidding when we said we were going to start a 
Question and Answer column, "Ask L.P." This does not mean that we 
will stop answering your questions; we will still take questions 
over tne phone or in person. But if you have any major questions, 
or questions that you think would help others, please send them to 
"Ask L.P.," care of Computer Mart. 
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A Preliminary Loox at Exidy's New DEVELOPMENT PAC 
by John Vacnon 


We've received a preliminary copy of the Soreerer's 
Development PAC and I've starting to work with it a little bit. 
Over-all the PAC looks like a powerful assembler-editor with many 
features. I am not that familiar with Z-80 programming, but I can 
give a general idea of wnat the PAC is like. For those who would 
like on-hand experience with the PAC, we have it at Computer Mart 
and you are welcome to come and try it out. 


The Development PAC comes in a standard 8-Track Tape-Housed 
ROM PAC and plugs into the side of the Sorcerer the same as the 
BASIC ROM PAC. The PAC has five basic modules to it: DDT80 
(Designer's Debbugging Tool), the EDITOR, the ASSEMBLER, a 
linking, relocating LOADER, and SORCERER I/O routines. The 
individual modules communicate with the Sorcerer through a 
"Vector" table and its entry points. The vector table consists of 
Console, Object and Source input and output, while the entry 
points, or drivers, are the physical interfaces (ie., keyboard, 
video, cassette, printer and memory buffers). These vectors must 
be set up before transfering control between modules. This 
control of I/0 constitutes the Sorcerer I/0 module. The other 
four modules are described below. 

DDT80 is the module that assumes control when the PAC is 
turned on. Control can be transferred to other modules through 
DDT80. Commands for DDT80 can manipulate memory and registers, 
execute modules, and do hex arithemetic. 

The Editor is a line oriented 2Z-80 Editor with standard 
editor commands that allow you to insert, delete or edit any 
number of lines of your text. The editor allows dumping of 
programs to cassette or RAM (again, depending on the I/0 vectors 
you have set up). 

Tne Assembler assembles the program and puts it in standard 
machine language format (see Tom Harper's article in this issue). 
The instruction manual contains operation procedures as well as 
assembly language syntax for tne assembler. 

I have not yet looked at the loader, although I can tell you 
that it is relocating and linking. | 


The instruction manual for tne PAC explains the operations of 
the modules in detail, but assumes that you know Z-80 machine 
language. The book does not try to teach this to you, but 
starting with this issue we will have a column in the newsletter 
to instruct you in programming with machine language. If you are 
interested in learnig Z-50 programming right away, we can suggest 
the reading of some of the books that are available at Computer 
Mart, such as The Z-80 Microcomuter Handbook. 
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Responses to our Questionnaires 


Hello! We're glad to have received so many responses to our 
questionnaires over the past two months, and this month we will 
publish the results of the questionnaires. AS you may know, the 


questionnaires were set up to help us find out what you are doing 
with your Sorcerer and what types of developments you would like 
to see. By passing this information on to the members of the 
User's Group, we hope that many of you who are doing the same type 
of work with your machines will get together and exchange ideas 
with each other. 

We regret that we do not have the resources to publish the 
individual results of each of the questionnaires, but we have 
tried to give an over-all view of the responses and to show some 
of tne more interesting applications of the Sorcerer. 

Even though we are unable to publish them, all the 
suggestions we have received will go into concideration for future 
newsletters and Sorcerer related projects. . 


PERIPHERALS: We received many varied accounts of peripherals 
on the Sorcerer; everything from a standard monitor and cassette 
to Dual Micropolis disks and IBM printers. 


USE: We received many interesting answers to the questions 
of why the person bought a Sorcerer and what he/she is using it 
ror. Many of the responses, of course, can be summarized in one 
word: fun. Others are using their machines for varied purposes: 
Geremaya is using a 32K Sorcerer with an IDS printer to do 
numerical and logical analysis; William Vetterling is using a 32K 
system with an S-100 expansion unit and an IBM typewriter to do 
word processing and research in language texts; Richard Piekarski 
tells us that he uses his Sorcerer for "fun and business in the 
office. Mostly business. Learning is the fun." Walter Gleason 
uses his 16K machine with an expansion unit as an at-home 
supplement for school and work assignments. Joseph Tupay bought 
his Sorcerer for “entertainment, calculation, learning, experiment 
and a great deal of curiosity." "Besides," he adds, "it's also a 
fine and versatile machine." 


WHAT YOU WOULD LIKE TO SEE: Here is where we got most of our 
information for what will be happening in the future. If anyone 
has any ideas for the subjects listed below, please contact us and 
we will put you in touch with the person or people who wanted that 
information. 

Utii2ties: Grapuie: 270 

Graphics: games; more control of graphics 


Machine language: programs; assembler; development of Z=-80 
based projects 
Info: internal operation of BASIC; location of variable 


storage; function entry points; technical descriptions 
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Interfaces: JOYSTICK controlling machines and robots; 
reading and sending code on a HAM radio station. 

Programs: training program for long distance runner; general 
business; mailing lists without a disk unit; bookkeeping, etc. 

Better RND# generator 

Improvements: better instruction manuals; more examples; 
on-line debugger; structured languages like PASCAL, TINY-C, etc. 

Instructions: how to use the ROM monitor; CHR3$ function 


We will be getting in touch with those of you who had wished 
to write an article for the newsletter. Let me assure you that 
your agreement to write an article does not mean that you still 
have to; if you have changed your mind about writing an article 
you simply have to tell us when we contact you. If, on the other 
hand, you would like to write an article but did not tell us 
earlier, please let us know that you do and what you want to write 
about. 
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A Z-80 Machine Language Primer 
by Tom Harper 


This assembly language primer is basically designed to introduce you, 
the beginning computerist, to the internal operations of your 
microcomputer, the Exidy Sorcerer, and to offer a beginners course in 
machine language programming. Your computer is composed of several parts. 
The first is the Central Processing Unit, or CPU. The CPU is the "brains" 
of the sorcerer. It does simple things like adding, subtracting, 
remembering numbers, as well as other more complex tasks. 

The next component is the memory. Your Sorcerer's memory was 
installed when you bought the system. It consists of what amounts to 
little cells, each of which can hold a number from 0 to 255, or 0 to FF in 
hexadecimal. Tne Sorcerers memory capacity is usually 8K, 16K or 32K. The 
'K' stands for 1024 memory cells, so 8K is 8192 cells, 16K is 16304 cells, 
and 32K is 32768 cells. This main memory is where your Sorcerer stores its 
programs, its data, and its calculations. Its one disadvantage is that the 
contents of these cells disappear when you turn the electricity off. That 
is why you have ROMPAC's, which are just like main memory except that their 
cells always keep the same value, power or not, and, cassette tape memory, 
which is permanent unless you record the top ten or your latest biorhythm 
program over the old data. The CPU, in fact, has a few of its own memory 
cells, which are much faster to use than main memory, as they are inside 
the computer chip. These are called Registers, and most of your computers 
operations are done in them, both for speed, and because of the fact that 
they are attached to the rest of the microcomputer chip's hardware. An 
example of how registers might be used is adding two registers together, 
and storing the result in one of them. Your Sorcerer's CPU, the Z-30, has 
two sets of eight registers which can be used and interchanged. These 
consist of 6 general purpose registers, an accumulator in which most math 
is done, and a flag set which ‘'flags' whether an operation was zero, 
positive, or negative, as well as other conditions. 

The last major component of your computer are the input/output 
devices. On the Sorcerer, the basic input devices are the keyboard and the 
cassette tape. The basic output devices are the screen and the cassette 
tape. Some other output devices are printers, card punches, and paper tape 
punches. Some other input devices are bar-code readers used in 
supermarkets, paper tape readers, and card readers. Some devices allow 
both input and output, although not necessarilly at = once. These are 
cassette tape, digital tape, and floppy and hard disks. All input/output 
devices communicate with the computer through a device called a ‘port’. 
There are generally two types of ports, serial ports and parallel ports, 
both of which your Sorcerer has. The major difference is that the serial 
port transmits its numbers in pieces, whereas the parallel port transmits 
the whole number at once. Obviously, parallel ports are faster than serial 
ports, but they are often much harder to use, on both a hardware and 
software level, and for some applications, they aren't necessary, such as 
keyboards, screens, and cassettes, which are slow anyway. Parallel ports 
are usually used for fast printers, or floppy disks, as well as high-speed 
data communications. Your Z-80 CPU allows you to access and communicate 
with up to 256 data ports, both input and output, both serial and parallel. 
Thus, you can access the keyboard, screen, cassettes, floppies, or printers 
on the machine language level. Fortunately for the beginners, and happily 
for those of you who are experienced in machine level programming, all of 


this can be nandled by the Sorcerer's Monitor program, or, as in the case 
of floppy disks, by the Disk Operating System (DOS), such as CP/M, MDOS, or 
North Star DOs. 

To become proficient in assembly language programming on your 
Sorcerer, you need several basic capabilities: 


1) You must know the instruction set of the CPU fairly well. 

2) You must know and be able to work with binary (base two), and 
nexadecimal(base sixteen). 

3) You need to practice for awhile to develop your capabilities. 

4) You need to develope or learn programming techniques to accomplish 
special tasks, just like BASIC. 

5) Reading assembly language programs once you get steps 1 + 2 out of 
the way helps a lot, especially if you can see what's really going on. 


In this first article, I would like to accomplish step two, getting to 
know how to use the numbering systems. In the ensuing months, Il will 
describe the instruction set and some useful programming techniques and 
ideas. 

As for numbering systems, I will introduce binary first, as I feel 
that a working knowledge of binary is instrumental in learning hexadecimal 
(sometimes called 'hex'). 

Binary (base two) is a numbering system used by almost all computers 
(IBM has some machines that use -decimal, but then what doesn't IBM 
hnave???!!!). Binary numbers are completely made up of ones and zeroes. 
This is useful to the machine because it now only has to worry about two 
states some part of the computer is in, such as power on/power off, switch 
on/switch off, plus/minus, etc. A binary digit is usually, and henceforth, 
referred to as a 'bit'. Four of these bits grouped together are a nybble, 
eight are a byte, and sixteen are a word. I guess thirty-two is a 
statement and sixty-four are a book - even though no one has really figured 
that out yet!!! The Z-380 usually handles numbers eight bits at a time, 
which is why it is called an eight-bit processor. Each memory cell, as 
well as each register, can hold eignt bits, or a number ranging from 0 to 
255. Sometimes two memory cells or two registers are paired up, forming 
sixteen-bit numbers ranging from 0 to 65535. Bits are usually numbered 
from right to left, starting at zero. Thus, in an 8-bit number, the bits 
are numbered 765 43210. The value of each bit is equal to two raised 
to the power of the bit number, or 2°7 2°6 2°5 2°4 2°3 2°72 2°1 2°0, or 128 
64 32 16 8 4 2 1, the total of which is 255. Thus, to represent a '6' in 
binary, you would have to turn on the four bit and the two bit (4+2=6), 
getting a result of 00000110. Actually, the largest number that can be 
represented by 'N' bits is the value 2°N-1, 2°8-1=255, 2° 16-1=65535. As an 
example, the binary number 10101010 base two is equal to 2°7+2°5+2° 3+2° 1, 
or 128+32+8+2, or 170 base ten. if all that is understood, we can now 
proceed with hexadecimal. Hex digits consist of the numbers 0-9, as well 
as the letters A-F. ‘'A's#10,. *B'=11, "Crst2, "D'al3, ‘*%H's14, - *FPst5. For 
anyone who hasn't noticed, a hex digit can easily replace four bits - 1111 
in Dinary=15 in decimal=F in hexadecimal, thus, any eignt-bit number can be 
represented by two hex digits, and sixteen-bits can be represented by four 
nex digits (personally, I prefer 'FFFF' to 65535!). 

Hexadecimal is generally useful only to the programmer, as the machine 
does everything in binary, and playing with bits usually isn't all the fun 
in programming... 

For those of you who display such masochistic tendencies as having 4 


great desire to convert from one number base to another, I have found that 
the easiest way to convert decimal to binary is to pick out the largest 
power of two the number can hold, turn on the corresponding bit number, 
subtract that power of two from the decimal number, and continue until you 
reach zero. For instance, to reverse our last example, 170(D) converted to 
binary goes like this: 


2°72128 fits 1------- 170-128 =42 
26264 doesn't 10 -----— 42-0 =42 
2°5=32 fits 10 1 ----— 42=32 =10 
2°4=16 doesn't 1010-<--- 10-0 =10 
2° 328 Fits 10101--<- 10-8 =2 
2-224 doesn't 101010-- 2-0 =2 
2. 1=2 fits 1010101= 2-2 =0 
2°0=1 doesn't 10101010 0-0 =0 


To gonvert decimal to hexadecimal, it's easiest to convert to binary 
first, then, taking the first four bits, represent them as a hex digit, and 
continue until you run out of bits - to use out example, the binary number 
10101010 is broken down into 1010 and 1010. 1010(B)=10(D)=A(H), so our 
first hex digit is 'A' and since the second four bits are also 1010, then 
our nex number is 'AA'. 


Simple, isn't it?!? For those of you who ‘said ‘no...', Texas 
Instruments makes a calculator called the TI Programmer which does all of 
this stuff for you in a flash, plus the usual +,-,/,*. It's available for 
between $40 and $50 and the price is expected to drop. I never program 
without it.(!?!) 


That just about wraps up this session of the Z-80 Machine language 
primer. Tune in next issue for a start into the Z-30 instruction set! 
Anyone who has any trouble with this, or would like further info, please 
feel free to give myself or John Vachon a call here at Computer Mart in the 
afternoons and evenings (3-7 usually). We recommend the purchase of "The 
Z-80 Microcomputer Handbook" at the paltry sum of 38.95 if you are 
seriously interested in learning the Z-80 machine language. We would also 
like some feedback on general confusions and what you'd like to know and 
see, which will be included in next months "Ask LP" column. 


Miscellaneous Info 
by Tom Harper 


As a favor to those of you who are programming in assembly language, 
without the aid of an assembler/editor, or a nice commented listing of the 
Sorcerer monitor, I would like to pass on some of the monitors special 
utility routines which will hopefully be of some assistance. 


E000: COLD enter monitor using 'cold' start 


£003: WARM enter monitor using ‘warm! start 
E005: USER enter monitor with 'user' info 
E009: CHRIN get character from current input device and return 


in the accumulator. 
EOOC: CHROUT output character to current output device from accumulator 
EOOF: TAPEIN input a character from tape and store in the accumulator 
E012: OUTAPE output accumulator to the tape 
£015: QUIKCK check to see if a ctrl/c or ese or run/stop has been hit 
E018: KEYBRD get a character from the keyboard into the accumulator 
EQ1B: VIDEO output accumulator to screen 
EQ1E: PARLIN input from parallel port to accumulator 
BO21: PARLOT output accumulator to parallel port 
E024: MOTRON turn cassette motor on for approx. 3 seconds 
E027: MTROFF turn cassette motor off 
E02A: BASSAV entry to BASIC csave command 
E02D: BASLOD entry to BASIC cload command 


The above, except for the last 4 are described in the sorcerer. user 
manuals. The last 4 I haven't used enough to give a good description of 
them, so you'll have to experiment on your own. The next several routines 
are imbedded in the monitor as part of it's own utility service routines: 


E1BA: MSGOUT outputs an ASCII text message which is pointed to by the H&L 
registers. The routine will continue until it reaches a NUL (0) 

E1E8: ADDOUT outputs the sixteen bit value in the D&E registers to the 
keyboard in hexadecimal 

BIED: HCHOUT outputs the value of the accumulator in hex 

£205: CRLF outputs carriage return/line-feed to terminal 

E20F: ADDCOL outputs D&E like ADDOUT, but adds colon and space 

$213 HEXSPC outputs a space then hex byte in accumulator 

E23D: CONVT reads ASCII hex number pointed to by H&L registers, then 

returns binary value in D&E - returns in E for 1 byte value 


Here is an RS232 printer driver for those of you who are naving trouble 
with your serial printer: 


Enter this hex code at zero (0000): 
0000: F5 F5 F5 FD 7E 3D F6 80 D3 FE F1 CD 12 £0 DB FD CB 47 28 FA F1 CD 
1B £0 F1 C9 


After you have done that, you can save it on tape with 'SA DVR 90000 
0019'. 
Now, using the 'SE 
printer, while 'SE T= 


' monitor command, 'SE T=1' will set for a 300 baud 
O' will set for a 1200 baud printer. Then type 'SE 


O=0000' and your printer will now speak! 


Some of you have expressed problems with the Sorcerer DUMBT progran, 
with the problems basically dealing with parity. Some of those big systems 
transmit parity bits which the Sorcerer neatly transforms into graphics 
characters. The solution to the problem is this: 


Read this section, then load DUMBT and enter the program to fix. 


0000 3 XxX LD A, VALUE 
0002 D3 FD OUT (OFDH),A 
0004 C3 00 O1 JP DUMBT 


VALUE is determined as follows: 


ra bit 0 
VALUE = X X xX P PS 8S NB2_ NB1 


Where: 
X=doesn't matter 
Psparity enable Osparity enabled leno parity 
PSsparity select Ozodd parity jseven parity 
Sz# of stop bits 0=s1 stop bit 1s2 stop bits 


NB2 # of bits per character 
NB1 # of bits per character 


| NBi ji NB2 j # of bits | 
{ QO i 0 ' 5 1 
' 1 1 0 i 6 i 
j 0) ' 1 | 7 j 
j 1 ) 1 i 8 j 


Thus, for a basic Sorcerer setup, you want: 
1) No parity © 
2) 1 stop bit 
3) 7 data bits 


Which equals '00010001' in binary or '11' in hex, so VALUE=11H 
Type 'EN 0000', then enter this nex code at zero: 
0000; 36-141. D3 FD C3 .00 01 


You can now save the new DUMBT program by 'SA'ting it starting at zero 
instead of at 100, or 'GO' at zero to set the DUMBT program at the new 
characteristics. 


For those of you who want to control iI1/0 dynamically from basic - 
these call commands should help: 


POKE Z=USR(0) Results 
260-------- 26 | nnn no on nn 9 nee eee 
253 229 SE O=V Sets output to the screen 
004 230 SE O=P Sets output to parallel port 
011 230 SE O=S Sets output to serial port - tape 
0138 230 SE O=L Sets output to the centronics 


or IDS parallel printer 
Just Poke the specified values into locations 260 and 261, then call 
the routine. 


That's all folks! Please send any questions and/or useful routines to 


me at computer Mart, or direct questions to the new ‘Ask LP' column and we 
will do our best to solve the problems and distribute the information. 
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CITY 


BELMONT, HA 
SUNNYVALE, CA 
BROCKTON, MA 
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ACTON, HA 
RIDGEFIELD, CT 
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NORWOOD, HA 
WATERTOWN, HA 


NEUTON, HA 


FELHAN, NH 
WALTHAM, MA 
WALTHAM, MA 
MEDFORD, HA 
NATICK, MA 
ARLINGTON, HA 
WALTHAM, MA 
UALFOLE, MA 
SUNNYVALE, CA 
PEMBROKE, MA 
NEEDHAM, HA 
WESTON, MA 
LEXINGTON, MA 
AUDUBON, PA 
BELMONT, MA 
BOSTON, MA 
BILLERICA, MA 
CONCORD, MA 


W. BRIDSEWATER, MA 


MARLBORO, MA 
BELLINGHAM, MA 
WALTHAM, HA 
DEDHAM, HA 

E. BOSTON, MA 
CAMBRIDGE, HA 
CAMBRIDGE, HA 
BEDFORD, MA 


—_—_— 


MEMORY 
8K 

32K 
14K 
16K 


SK? 


8k 
16K 
32K 
32K 
32K 
16K 
14K 
14K 
14K 
BK 
8k 
14K 
8K 
32K 
32K 
Sk 
32K 
32K 
Sk 
32K 


ee 


ay 
Ca 


min, 


be a] 


ng ¢ 


of aes! 


Pad on, 
fc? 47 % 


Or. OS td Be 


See? 


Here is our program of the month for those who have 
IDS printers. Not only does it make wallpaper and wrapping 
paper, but it sowuds interesting while its running, so give 
it a try! 
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